home *** CD-ROM | disk | FTP | other *** search
XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrr((((3333XXXX)))) NNNNAAAAMMMMEEEE XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrr - The DropTransfer widget class SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////DDDDrrrraaaaggggDDDDrrrroooopppp....hhhh>>>> VVVVEEEERRRRSSSSIIIIOOOONNNN This page documents version 1.2 of the Motif library. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN DropTransfer provides a set of resources that identifies the procedures and associated information required by the toolkit in order to process and complete a drop transaction. Clients should not explicitly create a DropTransfer widget. Instead, a client initiates a transfer by calling XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrrSSSSttttaaaarrrrtttt, which initializes and returns a DropTransfer widget. If this function is called within an XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc callback, the actual transfers are initiated after the callback returns. Even if no data needs to be transferred, XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrrSSSSttttaaaarrrrtttt needs to be called (typically with no arguments, or just setting XXXXmmmmNNNNttttrrrraaaannnnssssffffeeeerrrrSSSSttttaaaattttuuuussss) to finish the drag and drop transaction. The XXXXmmmmNNNNddddrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrrssss resource specifies a transfer list that describes the requested target types for the source data. A transfer list is an array of XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrrEEEEnnnnttttrrrryyyyRRRReeeecccc structures, each of which identifies a target type. The transfer list is analogous to the MULTIPLE selections capability defined in the _I_n_t_e_r-_C_l_i_e_n_t _C_o_m_m_u_n_i_c_a_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l (ICCCM). The DropTransfer resource, XXXXmmmmNNNNttttrrrraaaannnnssssffffeeeerrrrPPPPrrrroooocccc, specifies a transfer procedure of type XtSelectionCallbackProc that delivers the requested selection data. This procedure operates in conjunction with the underlying Xt selection capabilities and is called for each target in the transfer list. Additional target types can be requested after a transfer is initiated by calling the XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrrAAAAdddddddd function. SSSSttttrrrruuuuccccttttuuuurrrreeeessss An XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrrEEEEnnnnttttrrrryyyy is a pointer to the following structure of type XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrrEEEEnnnnttttrrrryyyyRRRReeeecccc, which identifies a selection target associated with a given drop transaction: ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt {{{{ XXXXttttPPPPooooiiiinnnntttteeeerrrr _c_l_i_e_n_t__d_a_t_a;;;; AAAAttttoooommmm _t_a_r_g_e_t;;;; }}}} XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrrEEEEnnnnttttrrrryyyyRRRReeeecccc,,,, ****XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrrEEEEnnnnttttrrrryyyy;;;; Page 1 (printed 4/30/98) XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrr((((3333XXXX)))) _c_l_i_e_n_t__d_a_t_a Specifies any additional information required by this selection target _t_a_r_g_e_t Specifies a selection target associated with the drop operation CCCCllllaaaasssssssseeeessss DropTransfer inherits behavior and a resource from OOOObbbbjjjjeeeecccctttt. The class pointer is xxxxmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrrOOOObbbbjjjjeeeeccccttttCCCCllllaaaassssssss. The class name is XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrr. NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss The following table defines a set of widget resources used by the programmer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. To reference a resource by name or by class in a .Xdefaults file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC prefix and use the remaining letters. To specify one of the defined values for a resource in a .Xdefaults file, remove the XXXXmmmm prefix and use the remaining letters (in either lowercase or uppercase, but include any underscores between words). The codes in the access column indicate if the given resource can be set at creation time (CCCC), set by using XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (SSSS), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (GGGG), or is not applicable (NNNN////AAAA). XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss __________________________________________________________________________________________________ XmNdropTransfers XmCDropTransfers XmDropTransferEntryRec * NULL CG XmNincremental XmCIncremental Boolean False CSG XmNnumDropTransfers XmCNumDropTransfers Cardinal 0 CSG XmNtransferProc XmCTransferProc XtSelectionCallbackProc NULL CSG XmNtransferStatus XmCTransferStatus unsigned char XmTRANSFER_SUCCESS CSG XXXXmmmmNNNNddddrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrrssss Specifies the address of an array of drop transfer entry records. The drop transfer is complete when all the entries in the list have been processed. XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttaaaallll Specifies a Boolean value that indicates whether the transfer on the receiver side uses the Xt incremental selection transfer mechanism described in _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s-_C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e. If the value is True, the receiver uses incremental transfer; if the value is False, the receiver uses atomic transfer. Page 2 (printed 4/30/98) XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrr((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrr((((3333XXXX)))) XXXXmmmmNNNNnnnnuuuummmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrrssss Specifies the number of entries in XXXXmmmmNNNNddddrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrrssss. If this resource is set to 0 at any time, the transfer is considered complete. The value of XXXXmmmmNNNNttttrrrraaaannnnssssffffeeeerrrrSSSSttttaaaattttuuuussss determines the completion handshaking process. XXXXmmmmNNNNttttrrrraaaannnnssssffffeeeerrrrPPPPrrrroooocccc Specifies a procedure of type XXXXttttSSSSeeeelllleeeeccccttttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkPPPPrrrroooocccc that delivers the requested selection values. The _w_i_d_g_e_t argument passed to this procedure is the DropTransfer widget. The selection atom passed is _MOTIF_DROP. For additional information on selection callback procedures, see _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s-_C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e. XXXXmmmmNNNNttttrrrraaaannnnssssffffeeeerrrrSSSSttttaaaattttuuuussss Specifies the current status of the drop transfer. The client updates this value when the transfer ends and communicates the value to the initiator. The possible values are XXXXmmmmTTTTRRRRAAAANNNNSSSSFFFFEEEERRRR____SSSSUUUUCCCCCCCCEEEESSSSSSSS The transfer succeeded. XXXXmmmmTTTTRRRRAAAANNNNSSSSFFFFEEEERRRR____FFFFAAAAIIIILLLLUUUURRRREEEE The transfer failed. IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss DropTransfer inherits behavior and a resource from OOOObbbbjjjjeeeecccctttt. For a complete description of this resource, refer to the OOOObbbbjjjjeeeecccctttt reference page. OOOObbbbjjjjeeeecccctttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss ____________________________________________________________________ XmNdestroyCallback XmCCallback XtCallbackList NULL C RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN OOOObbbbjjjjeeeecccctttt((((3333XXXX)))), XXXXmmmmDDDDiiiissssppppllllaaaayyyy((((3333XXXX)))), XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))), XXXXmmmmDDDDrrrraaaaggggIIIIccccoooonnnn((((3333XXXX)))), XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))), XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrrAAAAdddddddd((((3333XXXX)))), and XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrrSSSSttttaaaarrrrtttt((((3333XXXX)))). Page 3 (printed 4/30/98) 
